HagTerm ST v2.00 By Hagop Janoyan (c)1988 Atari Corner Publishing November 25, 1988 "HagTerm ST, the Solution to Your Terminal Needs!" NOTE: This program is shareware, meaning if you like it, pay for it! Also, even though both color and mono monitors are supported, this program is best suited to be run in medium res on a color monitor. More info will be found in this document: List of the ARC Contents: HAGTERM.PRG - Main compiled program. HAGTERM.TXT - This text file. HAGTERM.DEF - A sample saved default file. HAGTERM.DIR - A sample save dial directory file. WXYTR.TTP - Transfer program. TRANSFER.ACC - Transfer accessory. TRANSFER.RSC - Transfer Accessory Resource File ...and a collection of *.COM files (explained later) I. About HagTerm ST HagTerm ST is a simple to use terminal program. It includes a Transfer Mode, Terminal Mode, Dial Mode, and Buffer Mode. You can get more help from each section by pressing "HELP" while in the appropriate mode. II. Distribution And Shareware Notice I have put this program in the shareware. This means that you can distribute it as widely as possible. The more _you_ spread it around, the merrier I get! However, if you like HagTerm ST, please send a small donation to: Hagop Janoyan 515 Wing Street Glendale, CA 91205 Sending at least $10-$15 will get you registered. This will allow you to receive upgrade notices as they become available (hopefully, at least once in a week or two), and offer you the option to send your disk to receive the newest version. When you send in for an upgrade, I will also include the source code to this program (in GFA Basic), as well as some miscealeoneous utilities and upgrade files. If there is enough interest in this program, I will also create a manual to cover HagTerm ST feature by feature. The manual will then be sent to all registered users. However, this will only happen if I get around ten or so registered users, so don't hold your breath! NOTE: When you send your donation, please include your name, address, your phone number, and any comments you have. I also accept any suggestions for future versions of this program, so send in your comments! Of course, your suggestions would mean much more to me if they are sent with some money...[grin] III. Transfer Section After you use HagTerm ST, you will notice that the transfer section uses external programs to do the transferring. I did this because I was not able to write my own Xmodem/Ymodem routines. The program WXYTR.TTP, written by Thomas Zerucha, is used to act as a transfer section. HagTerm ST, therefore, will just act as a "Shell" to WXYTR.TTP. You must have WXYTR.TTP on one of the drives (or on a RamDisk) to properly transfer files. Other than that, this should be completely transparent to the user. NOTE: In this version, I also have allowed you to use the transfer accessory (TRANSFER.ACC, also written by Thomas Zerucha) to transfer files. This will not force you to have WXYTR.TTP available, and therefore allow users with only one drive to Transfer to other disks. IV. Accessories And HagTerm ST Even though GFA Basic (on which this program was written with) does not "like" accessories, I was able to get around this problem and allow the user to use most of the ST Desk Accessories without any problems. However, programs that use their own window will generally not work properly. As soon as I receive GFA Basic version 3.0, I will then be able to fix that probem. But for now, I tested this with many Accessories, and most seem to work well. V. Record Files And Logon Scrips There are two ways which you can automate your logon process in HagTerm. One was is the Record/Compile/Playback process through the Main Menu. Another way is the Logon Script through the Dial Mode. Both serve the same purpose, but each offer different advantages and disadvantages. RECORD/PLAYBACK - To use this feature, you first must choose "RECORD" thru the Main Menu. After you select the correct file, the program will then monitor your keypresses while you are in the Terminal Mode. They will be saved to the disk under the specified file. You may also press Alt-1 to get a Dialog Box. With this feature, you are able to ask for a User Name/Pass from the user when he "Compiles" it, for example. The best way to understand this is to try it yourself, and also test the sample un-compiled *.COM files. After you are finished, press on "RECORD" again, or use ALT-R through the terminal mode. Now, you must "COMPILE" it through the Main Menu. As you do so, you will be prompted for Input if you used "ALT-1" while you were recording. The questions you will be asked is what you Inputed in the Dialog Box when you pressed Alt-1 while you were recording. Now, you are ready for "PLAYBACK." You can do this in two ways, depending on what you recorded. You can do it through the Main Menu, at which time it will switch to the Terminal Mode and Playback your recorded file. You may, however, playback the file through the Dial Mode. For example, you may playback the file after you are connected to a BBS while Auto-Dialing. You can do this through the "Settings" menu. Again, it is best that you experiment with this feature, as you can do a lot with it. LOGON SCRIPTS - A faster way of automating is through the Dial Mode, "Script" icon. Click on the "SCRIPT" icon, and a Dialog Box will appear. You may then specify a string to "Wait" for, and then a string to "Output" when the Wait string is found. There are samples of Logon Scripts in the HAGTERM.DIR file for specific BBS's, so again, experiment with them. VI. Future Upgrades Some of the future plans for HagTerm ST include: 1) A much improved Buffer Mode 2) Connect detect feature 3) DTR drop 4) Improved Dial Mode 5) Better disk drive operations 6) Compact Code = Smaller Program Size 7) Keyboard Translation 8) Definable Emulations (eg. Ansi Emulation) - almost finished ...and maybe in the not-so near future: 10) My own routines for X/Y/Zmodem 11) Support for .DO Flash files 12) One line commands similar to Flash 13) Support for a non-GEM interface 14) ...and maybe Convert And Compile in C or Pascal For Even Faster Execution Speed and Even More Compact! Basically, I have some very exciting upgrades planned when I get my GFA Basic 3.0 upgrade! VII. Miscellaneous Revisions: This should be the first upgrade of HagTerm. There are other versions out in the public domain, but I purposely did not allow it to spread around as it was not "complete". Hopefully, this version will satisfy most of you and will act as a "complete" terminal program with no fatal changes needed. Atari Corner Publishing: You might have already noticed that this program is copyrighted by "Atari Corner Publishing". I have used the name Atari Corner Publishing to represent my not-so-many public domain programs. It is in no way connected with Atari Corporation. Source Code: This program is written completely in GFA Basic (except for the Transfer programs [see above]). Since there are many fans of GFA Basic out there, who would like any new hints and tips they can get their hands on, I will gladly give the source code of this program to anyone who requests for it. You might also be able to find the source code of this program on a few Bulletin Board Services, so download it at will and spread them to your friends! HOWEVER, I WILL NOT ALLOW _ANYONE_ TO MODIFY THE PROGRAM AND RELEASE IT BACK INTO PUBLIC DOMAIN/SHAREWARE. If you do modify, and feel that it should be in the public domain, then please consult it with me first. About Me: I am known as the "Atari Corner" on most Bulletin Board Services that I call. You can find me in one of these BBS's (Sorry, but I do not call any pay-services regularly): ST Jungle ==========> 213-254-9534 Infinity ===========> 818-760-0943 Dead Graveyard =====> 818-848-4236 O-Mayer V ==========> 213-732-0229 IIX. Final Notes Remember, this program is in Shareware. So, if you like this program, send in your donations. If you want more support, send in your donations. If you need more goodies, send in your donations. If you want to support the Shareware concept, send in your donation. If you want to support the ST community, send in your donation. Or, if you simply just want to put a smile on my face, then send in your donations TODAY! This is my first program that I am satisfied with, so I hope you will be satisfied as well. Hopefully, this program will spread around and get to as many people as possible. Hagop Janoyan July 27, 1988 --------------------END--------------------